home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Utilities / Analyse & Test / Test Utilities / SCSI Utilities / DiskBasher / Read Me < prev   
Text File  |  1990-06-29  |  6KB  |  136 lines

  1. DiskBasher 1.1 - June 29th 1990
  2. by Stephan Somogyi
  3. The software and this documentation © 1988-1990 MacUser Labs
  4. All rights reserved
  5.  
  6. Permission is granted to make and distribute copies of the software and accompanying documentation for non-profit purposes only. The DiskBasher package may not be included in any for-profit product. This documentation is part of the DiskBasher package and must accompany the software.
  7.  
  8. • DISCLAIMER
  9.  
  10. Use this software at your own risk.
  11.  
  12. While we have gone to great lengths to ensure that this application is bug-free, neither the author nor his employer make any claims, express or implied, about the suitability of this software for any purpose whatsoever.
  13.  
  14. • Preface
  15.  
  16. DiskBasher is MacUser’s mass storage benchmark. Please read this entire file before using DiskBasher. It’s not that long and you will end up with a much better idea of what DiskBasher is all about.
  17.  
  18. • What Does DiskBasher Do
  19.  
  20. DiskBasher is an application that measures hard disk performance. It creates a temporary file on a volume and executes a number of writes, seeks, and reads within that file. When DiskBasher finishes, the temporary file is deleted and the time taken to perform the test is displayed.
  21.  
  22. • How To Use DiskBasher
  23.  
  24. DiskBasher must be launched from the volume to be tested.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45. In DiskBasher’s main selection dialog you have the option of choosing the write/read/seek increments and the size of the test file. For historical reasons, the default settings are “Random” and a 10MB file. These setting were used in all MacUser Lab Reports that published DiskBasher results.
  46.  
  47. The explicit block sizes are self-explanatory: if you select a 10kB block size and a 10MB file size, DiskBasher writes 10kB, seeks back, and rereads the 10kB just written. Cycle repeats.
  48.  
  49. Random picks one of the sizes (from 10kB to 200kB) per cycle and goes through the file until no more room is left in the file.
  50.  
  51. Mix uses a pre-defined selection of block sizes. We will probably be switching to Mix rather than Random as the default test setting in the near future since the sequence of block sizes are repeated exactly.
  52.  
  53. • Why Does DiskBasher Exist
  54.  
  55. DiskBasher was created because we felt a need for a mass storage benchmark that mimicked an application’s behavior as closely as possible. Many heated debates raged over whether to use a “real” application to perform tests or to make an “artificial” benchmark. In the end, the decision was made to create DiskBasher; if it correlated with the results we got from using “real” apps, we would to use it.
  56.  
  57. It did (very well) and we have ever since.
  58.  
  59. DiskBasher 1.0.3 was the version used in-house since December 1988. It was released to a few vendors who wanted to be able to reproduce our testing with new drives. If you have a copy of 1.0.3 delete it. Version 1.1 supersedes 1.0.3.
  60.  
  61. 1.0.3 was never released to the public at large since it was something of a kludge. This is not to say that 1.1 isn’t, it’s just that 1.1 has gone through very rigorous testing (see below) and it actually handles error conditions (see below as well).
  62.  
  63. • Error Messages
  64.  
  65. Ideally, DiskBasher will never display an error dialog. But, since Murphy was an optimist, DiskBasher 1.1 checks for some error conditions and reports them.
  66.  
  67. The most common error message is
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77. This dialog is displayed when DiskBasher does not have enough room on the disk to create even a minimal (512kB) test file, or that the available room is not contiguous. The free space must be contiguous so that the File Manager doesn’t waste time figuring out where a particular piece of the test file resides.
  78.  
  79. The next most likely error dialog to appear is
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88. This is the generic error dialog and will only provide a relatively cryptic OS error number. If you get this dialog, it usually means something has gone amiss with the test file.
  89.  
  90. Before going into conniptions, restart your Macintosh, and run DiskBasher again. In almost all cases, a restart will get rid of the problem. Since polyINITism and MultiFinder use run rampant, it is quite possible that some other process is running amok behind DiskBasher’s back. We run DiskBasher without MultiFinder and only with those INITs required for a drive’s operation.
  91.  
  92. If you encounter a repeatable error *please* send a bug report using one of the methods described below. Provide as much detail as possible about what you did to recreate the error.
  93.  
  94. • Development Tools Used
  95.  
  96. DiskBasher was developed with Symantec’s THINK Pascal 3.0. It is written entirely in Pascal, except for roughly 20 lines of inline assembler. DiskBasher 1.1 would not exist in its present form without Resorcerer from Mathemæsthetics and Apple’s ResEdit 2.0b2.
  97.  
  98. • Testing
  99.  
  100. We tested DiskBasher in the following (sometimes hostile) environments:
  101.  
  102. - MacsBug’s Heap Scramble
  103. - System 7.0a9
  104. - A/UX 2.0
  105. - Mr. Clean’s Mysterious Hole
  106. - Mr. Bus Error
  107.  
  108. Other than the normal kind of weird stuff that happens in high-stress environments (ever had Heap Scramble purge a button out from under you immediately after a GetNewDialog and before you could even do a HiliteControl?), DiskBasher 1.1 functions under these conditions.
  109.  
  110. DiskBasher is 32-bit clean and was tested on Macs ranging from the Plus to the IIfx and whichever drives happened to be connected to the CPUs at the time.
  111.  
  112. • Virus Information
  113.  
  114. In normal operation DiskBasher will not set off anti-viral alerts. The DiskBasher application should also never be modified. There is cause for suspicion if your anti-viral protection ever brings up an alert that DiskBasher is being modified.
  115.  
  116. We strongly recommend that you use anti-viral software if you do not already do so.
  117.  
  118. • Bug Reports,  Problems and Suggestions
  119.  
  120. If you want to report a bug or a problem or suggest an improvement, please use one of the following methods to reach me:
  121.  
  122. Stephan Somogyi
  123. NetWorkShop Manager
  124. MacUser
  125. 950 Tower Lane, 18th Floor
  126. Foster City, CA 94404
  127.  
  128. CompuServe/ZMac: 72511,40
  129. Internet: MacUserLabs@cup.portal.com
  130. America Online: MacUserNWS
  131.  
  132. No phone calls please.
  133.  
  134. • The Bonus
  135.  
  136. If you've read this far, you deserve a small token of our appreciation. There are one or more hidden about boxes in DiskBasher. However, using ResEdit to ferret around won't do you any good.